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(57) Abstract: Dynamic management proxies provide type-safe, intu- 
itive, and flexible interfaces to management entities. In an embodiment, 
a strongly-typed user interface (270) is defined for each management 
entity. The dynamic proxy receives user requests via this user inter- 
face. The dynamic proxies converts user requests into generic requests 
in compliance with the management entities generic interface (280). 
The generic requests are communicated to the management entity via 
the generic interface. Dynamic management proxies are created at run- 
time. This allows the management interface to be seamlessly extended. 
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METHOD AND APPARATUS FOR USING JAVA DYNAMIC 
PROXIES TO INTERFACE TO GENERIC, BEAN-LIKE 
MANAGEMENT ENTITIES 



COPYRIGHT NOTICE 
A portion of the disclosure of this patent 
document contains material which is subject to copyright 
protection. The copyright owner has no objection to the 
facsimile reproduction by anyone of the patent document 
or the patent disclosure, as it appears in the Patent and 
Trademark Office patent file or records, but otherwise 
reserves all copyright rights whatsoever. 



Statement of Priority 
[0001] This application claims priority under 35 U.S.C. §1 19(e) 
from United States Provisional Patent Application Serial No. 60/325,863, 
filed September 28, 2001 , and entitled "Method and Apparatus for Using 
Java Dynamic Proxies to Interface to Generic, Bean-Like Management 
Entities." The cited application is incorporated herein by reference. 



Field of the Invention 
[0002] This invention relates to an apparatus for interfacing with 
management entities across a distributed computing environment. 



Background of the Invention 
[0003] A distributed computing environment is comprised of a 
group of networked computers working in concert to provide a variety of 
computing services. In this type of computing environment, software 
applications are separated into many application components. These 
components are distributed across the network of computers, so that 
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dHTerent components may be executed by different computers within the 
distributed environment. The application components are designed to 
effectively operate in a distributed environment. The advantage of 
designing applications for a distributed computing platform include 

5 increased scalability to accommodate a large numbers of users, 

increased reliability, and efficient use of computing resources. 
[0004] One example of a distributed computing environment is 
the Java™ 2 platform, Enterprise Edition (J2EE) architecture, which was 
developed by Sun Microsystems. J2EE applications are comprised of 

10 primarily of Enterprise Java™ Beans (EJB), which are self-contained, 

reusable application components written in the Java™ programming 
language. The specification for the J2EE architecture is described in 
Java™ 2 Platform Enterprise Edition Specification, v1.3, available at 
http://iava.sun.com/i2ee/j2ee-1 3-pfd4-spec.pdf and incorporated by 

15 reference herein. 

[0005] In the J2EE architecture, application components are 
executed within an application server program installed on each 
computer in a distributed computing environment. The application 
components for an application may be spread over many application 

20 servers within the distributed computing environment, or concentrated 

within a single application server located on a single computer. 
[0006] The J2EE application server program provides low-level 
functionality needed by application components in a distributed 
programming environment. The functions provided by the J2EE 

25 application server program include enabling communication between the 

distributed application components, as well communication between 
different applications located within the distribut d computing 
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environment oroutside this environment The application server handles 
system resources, threads, memory, database connections, security, 
client connectivity, and transaction management. By integrating these 
functions into the application server, the J2EE platform allows 
5 application developers to concentrate on implementing the business 

logic of the application, rather than low-level functionality required by 
distributed applications. 

[0007] As with any large-scale system, proper configuration and 
continuous monitoring of the distributed computing environment is 

10 essential to the system's successful operation. For example, a system 

administrator may need to monitor runtime statistics of the distributed 
computing environment in order to prevent a component of the 
environment from failing. Examples of such statistics include memory 
usage, the number of users, or the number of transactions. When one 

IS component of the distributed computing environment fails, the system 

administrator may need to reconfigure other portions of the distributed 
computing environment to compensate. At the same time, the system 
administrator may be able to reconfigure and repair the failed 
component. All of these tasks may be done with management software 

20 integrated into the distributed computing environment. In J2EE 

distributed computing environments, the application server may provide 
management resources for controlling the configuration and operation 
of J2EE applications and their respective components. 
[0008] Despite its advantages in scalability, reliability, and 

25 efficiency, a distributed computing environment can be difficult to 

manage. Each of the numerous components of the distributed 
computing environment may need to be separately configured and 
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monitored. With a large application, this presents thousands of different 
attributes that must be managed. 

[0009] One way of efficiently managing a distributed computing 
environment is through the development of customized management 
5 software. In order to facilitate the development of management 

software, various standard system management protocols have been 
developed. These protocols allow management software to send and 
receive management information to any application or system 
component that has implemented the management protocol. Examples 
10 of management interfaces include the Simple Network Management 

Protocol (SNMP) and the Web-Based Enterprise Management (WBEM) 
standard. These management interfaces are independent of any 
particular type of computing platform. 

[0010] Within the Java™ programming language, the Java™ 
15 Management Extensions (JMX) define a Java™-based architecture, API, 

and services for application and system management. JMX allows 
Java™ applications to become manageable without substantial 
modification. The specification for the Java™ Management Extensions 
standard is located at 
20 http://java.sun.com/aboutJava/OT 

and is incorporated herein by reference. Since JMX is integrated into 
the Java™ programming language, JMX can fully utilize the functionality 
of other existing Java™ APIs, such as Java™ Naming and Directory 
Interface (JNDI), Java™ Database Connectivity (JDBC), and Java™ 
25 Transaction Services (JTS). Further, JMX can be integrated with other 

management protocols such as SNMP and WBEM, enabling uniform 
management of both Java™ and non-Java™ applications. 
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[001 1 ] Figure 1 shows the basic JMX architecture implemented 
in the J2EE platform. Implementations in other Java™ platforms, such 
as Embedded Java™, follow a similar model. J2EE Application Server 
100 executes J2EE components, such as EJBs. Additionally, the 
5 Application Server 100 contains Managed Beans (MBeans) 105, 110, 

and 115. Application Server 100 may have any number of MBeans. 
Each MBean represents a different manageable resource. Examples 
of manageable resources may include an implementation of a service, 
an application, or a device. Additionally, MBeans 105, 110, and 115 

10 may represent MBeans for manageable resources associated with 

Application Server 1 00. Examples of manageable resources associated 
with application server 100 include network resources, such as the listen 
port, security settings, such as encryption levels, and run-time 
operations, such as server shutdowns, startups, and suspends. 

15 [0012] MBeans are Java™ objects with attributes and methods. 

When an M Bean's methods are invoked or an MBean's attribute are 
altered, the corresponding manageable resource will be affected 
accordingly. MBeans 105, 110, 115 are registered with MBean Server 
130. MBean Server 130 is also located on Application Server 100. In 

20 an alternate embodiment, MBean Server 130 is located on a remote 

server. In a further variation, MBeans may be registered with multiple 
MBean Servers. MBean Server 130 directly controls its registered 
MBeans and makes them available to remote management applications. 
The MBean Server 130 includes a set of services for managing 

25 MBeans. These services include communication to and from each 

MBean, as well as services for creating and removing MBeans. 
[0013] MBean Server 1 30 also communicates information to and 
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from Management Applications 140, 150 and 160. Management 
Application 140 is a Java™ application integrated into the Application 
Server 100, while Management Applications 150 and 160 are remote 
applications. The remote Management Applications 150 and 160 may 
be located on a Java™ platform or an external, non-Java™ platform. 
Management Application 150 uses a non-JMX management protocol, 
such as SNMP or WBEM. MBean Server 130 translates information 
between the non-JMX Management Application 150 and MBeans 105, 
110, and 115. 

[0014] Management Application 1 60 is a remote MBean Server. 
The remote MBean Server includes similar functions as MBean Server 
130, including services for communicating with MBeans and 
Management Applications. Additionally, MBean Server 160 aggregates 
MBeans from Application Server 100 and Application Server 180. 
Information from MBean Server 160 may be passed to MBeans on 
Application Servers 100 and 180 directly, or through a local MBean 
Server. Any number of intermediate MBean Servers may exist in a 
distributed computing environment. 

[0015] The JMX standard provides a uniform, Java™-based 
architecture for application and system management. In order to 
accommodate a wide variety of manageable resources, JMX defines a 
set of very generic interfaces for managing MBeans. For example, the 
code "void setAttribute(Object Identifier, Object attributes)" sets MBean 
attributes, while the code "Object getAttribute(Object Identifier, String 
attributeName)" would retrieve an MBean attribute. 
[0016] The generic interface presented by the JMX standard is 
error prone on many levels. First, the correct obj cts and attributes 
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used in a given method call will vary depending on the MBean called. 
Errors can result in several ways if the user application enters the 
incorrect objects or attributes when managing a MBean. If the user 
application misspells the name of the desired MBean or attribute, the 
method call will fail at runtime. Sometimes the user application will call 
a MBean method with a series of multiple attributes. If the attributes are 
miscounted or misordered, additional errors will result at runtime. Even 
if the user application configures the method call correctly, the user 
application could pass an invalid value for an attribute. For example, an 
attribute may have a valid numerical value between 1 and 1 0. A runtime 
error will result if the user application passes a value of 1 1 for this 
attribute. 

[001 7] Another problem results from using the wrong data type. 
Information used by MBean may be in the form of a specific data type. 
Examples of simple data types include strings and integers, which 
describe text and integer numbers, respectively. More complex data 
types are also used, such as ListenPort, which describes a servers 
network listen port setting. In the generic interface provided by the JMX 
standard, attributes are data typed with broad type of Object. It is up 
to the user application to ensure that this broad data type is handled 
properly. To do so, the user application must know in advance the more 
specific type of data used by the MBean and properly cast the specific 
data type. If this is done incorrectly, an error will result at runtime. 
[0018] Additional problemsoccurduetothevarietyof information 
represented by MBeans. Many MBeans may represent manageable 
resources that are read-only. Examples of these attributes include 
server statistics, which can be read by the user application, but not 
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written to. Other MBeans may be write-only. Examples of these 
manageable resources include operations for starting, stopping, and 
resetting application servers. Attempting to read a write-only MBean, or 
vice-versa, will result in an error. 

[0019] Compounding this problem, many of these errors often 
occur only at runtime, after the application is deployed. This make 
debugging more time consuming, since the application must be 
deployed in order for the error to become apparent Also, runtime error 
messages generally very vague, making it difficult to trace the source of 
the error. 

[0020] Previously, the burden is on the user application to 
correctly employ MBeans with correctly named and ordered attributes, 
legal attribute values, and the correct data type. With the wide variety 
of MBeans, each with different requirements, user application mistakes 
are commonplace. Therefore, it is desirable to have an apparatus for 
employing MBeans which 1) prevents misnamed objects or attributes, 
2) catches illegal attribute values, 3) avoids errors in casting data types, 
4) prevents errors resulting from using the wrong function on a MBean, 
and 5) reduces the occurrence of difficult to trace runtime errors. 
Additionally, it is desirable that this apparatus is intuitive and easy to 
use. Further, it is desirable that this apparatus be dynamic, so that 
management interfaces may be extended at runtime. 

Summary of the Invention 
[0021] According to the invention, generally, a proxy for 
controlling a management entity includes a strongly-typed user 
int rface for communicating with a user application. The user interface 
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defines a plurality of userfunctions for performing operations on specific 
portions of the management entity. The proxy includes a translator for 
converting userfunctions into at least one corresponding management 
function, and a management interface for communicating with the 
5 management entity through the corresponding management function. 

[0022] Other embodiments and advantages of the present 
invention can be seen upon review of the figures, the detailed 
description, and the claims which follow. 

10 Brief Description of the Figures 

[0023] The present invention will now be described with reference 
to the drawings, in which: 

[0024] Figure 1 illustrates the Java™ Management Extensions 
(JMX) architecture; 

15 [0025] Figure 2 illustrates the operation of a dynamic MBean 

proxy according to an embodiment of the invention; and 
[0026] Figure 3 illustrates a distributed computing environment 
incorporating an embodiment of the invention including MBean Servers 
for controlling MBeans and MBeanHomes for creating dynamic MBean 

20 proxies. 

[0027] The invention will be better understood with reference to 
the drawings and detailed description below. In the drawings, like 
reference numerals indicate like components. 



25 



Detailed Description 
[0028] The invention addresses the shortcomings of prior 
distributed computing nvironments by 1 ) preventing misnamed objects 
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or attributes, 2) catching illegal attribute values prior to runtime 3) 
avoiding errors in casting data types, 4) preventing errors resulting from 
using the wrong function on a MBean, and 5) reducing the occurrence 
of difficult to trace runtime errors. Further, the invention provides an 
5 intuitive and easy to use MBean interface that is dynamically extendable 

at runtime. 

[0029] An embodiment of the invention achieves these goals 
through the use of dynamic MBean proxies. MBean proxies serve as an 
intermediary between MBeans and the userapplication. Figure 2 shows 

10 the operation of a MBean Proxy in a J2EE system. Information passes 

from the User application 200, through MBean Proxy 220, through one 
or more MBean Servers 240, to MBean 260. 
[0030] Information is returned to the User 200 from MBean 260 
along this same path. Unlike the standard generic JMX interface for 

15 accessing MBeans through an MBean Server, MBean Proxy 220 

presents a Strongly-typed Interface 270 to User 200 and a Generic JMX 
Interface 280 to MBean Server 240. MBean Proxy also contains Code 
290 for converting the methods of Strongly-typed Interface 270 into 
correctly formatted methods of the Generic JMX Interface 280. 

20 [0031] Each MBean proxy represents a single MBean. This 

allows the interface of each MBean proxy to be customized according 
to the requirements of its corresponding MBean. In an embodiment, 
each MBean proxy is dynamically created when the user application first 
requests a specific MBean. Once a MBean proxy is created for a 

25 specific MBean, the MBean proxy becomes a persistent object. 

Additional MBean accesses are conducted through the previously 
created MBean proxy. Direct user access to the MBean is unnecessary, 
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and the user may treat the MBean Proxy as if it were the MBean itself. 

[0032] Dynamic MBean proxies eliminate many of the sources of 
error associated with the generic JMX interface. First, dynamic MBean 

5 proxies do not have errors from misnamed MBeans and attribute. In an 

embodiment, the user application must obtain each MBean Proxy 
through a name search prior to the initial access of the MBean proxy. 
The Java™ Naming and Directory Interface (JNDI) provides one type of 
name search. JNDI is a standard Java™ language extension for 

10 locating Java™ objects. If the name is misspelled, the name search will 

fail and the user application will be unable to attempt to access the 
nonexistent MBean proxy. If the name search is successful, then the 
MBean is guaranteed to exist and access may proceed normally. 
[0033] Dynamic MBean proxies also avoid problems stemming 

15 from illegal attribute values. In an embodiment, each specific MBean 

interface is declared prior to compilation of the user application's code. 
For many attributes, this interface declaration also defines valid attribute 
values. If an illegal attribute value is passed prior to compilation, the 
compiler will catch this error. Illegal values passed at runtime will 

20 generate an illegal attribute exception, which can be handled by the user 

application. 

[0034] Dynamic MBean proxies provide a strongly-typed interface 
which prevents a user application from erroneously passing attributes 
with the wrong data type. In an embodiment, each MBean proxy 
25 interface is declared prior to compilation. This interface declaration 

defines a specific data type for each MBean attribute. In order to pass 
data to a specific attribute through an MBean proxy, the data must be 
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contained in the correct data type. This is done in the user application 
code by storing the data in an object of the correct data type or by 
converting or "casting" the data into the correct data type for the desired 
attribute. Attributes returned by MBeans must also be cast into the 
5 correct data type. Failing to correctly set data types in the user 

application code will prevent the source code from compiling. Once the 
user application has been successfully compiled, this embodiment 
ensures that the application will be free of runtime errors associated with 
wrong data types. 

10 [0035] Further, the strongly-typed interface provided by dynamic 

MBean proxies prevents the user from calling the wrong function on an 
MBean. In an embodiment, each MBean Proxy interface is declared 
prior to compilation. Since each MBean interface is configured 
specifically for a given type of MBean, the MBean proxy interface 

15 declaration will only contain valid functions for a given MBean type. 

Invalid functions for a given MBean type are not defined by the MBean 
proxy interface. If the user application code attempts to call an invalid 
function for a given MBean, the application will not compile. Instead, the 
compiler will generate an error message pointing out that the requested 

20 function is not defined for a given MBean type. This eliminates runtime 

errors associated with invalid function calls. 

[0036] In addition to preventing many types of errors, dynamic 
MBean proxies reduce the severity of errors when they occur. For many 
types of errors discussed above, MBean proxies will generate compiler 
25 errors when the user makes a mistake. In contrast, similar mistakes 

underthe generic JMX interface will result in runtime errors. In general, 
these runtime errors are less specific and harder to trace than their 
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corresponding compiler errors. Furthermore, the programmer saves 
time by detecting and eliminating many errors without having to deploy 
the application. 

[0037] Dynamic MBean proxies also provide an intuitive and easy 
to use interface to MBeans. The strongly-typed interface of MBean 
proxies is structured similarly to the interface provided by Enterprise 
Java™ Beans. Since many Java™ programmers are already familiar 
with EJBs, MBean proxies make it easier for programmers to write user 
applications. It also allows Java™ programmers to access MBeans in 
a manner consistent with EJB, simplifying application development 
[0038] In an embodiment, MBean proxies are created dynamically 
at runtime. This allows for seamless extension of management 
interfaces at runtime. MBean proxies are created by a special object 
known as an MBeanHome. Figure 3 shows a distributed computing 
environment incorporating an embodiment of the invention including 
dynamic MBean proxies and several MBeanHomes. 
[0039] The distributed computing environment 300 contains a 
plurality of computers 310, 320, 330, and 340. The four computers 
shown are for the purpose of illustration. A distributed computing 
environment may contain a single computer up to any number of 
computers. Each of the computers contains the underlying hardware 
and software necessary to operate in a distributed computing 
environment. This includes one or more processing devices, memory 
devices, data storage devices, communications devices, and any 
associated software. The usage of these hardware and software 
components in a distributed computing environment are well known in 
the art. Although not shown in Figure 3, the distributed computing 
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environment 300 may include communication connections for 
exchanging information with external systems external systems such as 
client computers, databases and other enterprise systems, monitoring 
systems, and data storage systems. 

[0040] All of the computers in the distributed computing 
environment 300 are in communication with each other via 
communication link 350. Communication link 350 may be a computer 
network, such as a local area network or a wide area network, and may 
employ any type of communications technology capable of carrying 
information. The number and arrangement of the communication 
connections comprising communication link 350 shown in Figure 3 is for 
purposes of illustration and communication link 350 may be configured 
in any suitable manner known in the art for connecting computers. 
[0041] Computer 310 contains server programs 312 and 314. 
Each of these server programs is capable of independently executing 
one or more distributed applications or application components. Server 
programs 312 and 314 are shown in Figure 3 for the purposes of 
illustration and computer 310 may contain a single server program up 
to any number of server programs. Similarly, computers 330 and 340 
contain server programs 332, 334, 342, and 344, respectively. In an 
embodiment, each server program is a J2EE application server capable 
of executing one or more J2EE applications or application components. 

[0042] Computer 320 contains an Admin Server program 325. 
The Admin Server 325 supervises the management of the entire 
distributed computing environment. Computer 320 may also contain 
other programs not shown in Figure 3. In an embodiment, computer 
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320 contains an Admin Server 325 as well as one or more server 
programs, such as those discussed above. 

[0043] In an embodiment, Server program 342 contains an 
MBean Server 345 and an MBeanHome 347. MBean Server 345 

5 directly controls the MBeans located on Server Program 342. These 

MBeans correspond to management resources for applications on 
Server program 342 as well as management resources for Server 
program 342 itself. MBean Server 345 provides access to MBeans 
through the generic JMX interface. MBeanHome 347 creates dynamic 

10 MBean proxies for MBeans located on Server program 342. Both 

MBean Server 345 and MBeanHome 347 access the same set of 
MBeans. In a further embodiment, a MBean Servers and a 
MBeanHome are located on each Server Program in the distributed 
computing environment. Each MBean Server and MBeanHome enables 

15 access to all the MBeans on their respective Server Programs. 

[0044] An additional embodiment includes MBean Server 327 and 
MBean Home 329 on Admin Server 325. The MBean Server 327 and 
MBeanHome 329 enable access to the MBeans on Admin Server 325. 
These include MBeans for managing applications running on Admin 

20 Server 325 as well as MBeans for managing Admin Server 325. Unlike 

other MBean Servers and MBeanHomes, the MBean Server 327 and 
MBeanHome 329 on the Admin Server 325 further enable access to all 
the MBeans in the entire distributed computing environment 300. 
[0045] In an embodiment, MBean proxies are created by the 

25 MBeanHome. The user can request a dynamic MBean proxy for a 

specific MBean from the MBeanHome. In response, the MBeanHome 
returns a dynamic MBean proxy to the user corresponding to the 
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requested MBean. Alternatively, the user may employ the MBeanHome 
to search for MBeans meeting a specific criteria. Searches may be 
conducted by any combination of MBean attributes, MBean types, or 
MBean Servers. For example, a search could request MBeans for all 
5 servers using a listen port set to 7001 . In response to a search request, 

the MBeanHome returns a group of MBean proxies matching the search 
request. In an embodiment, the group of MBean proxies are returned 
inside of a Java™ iterator object. The user then extracts each MBean 
proxy from the iterator. 
10 [0046] Internally, an embodiment of the MBeanHome creates 

dynamic MBean proxies in the following manner. First, the MBeanHome 
receives a request from the user for a dynamic MBean proxy for a 
specific MBean. The MBeanHome makes a generic JMX call on the 
MBean Server requesting MBean information for the specific MBean. 
15 [0047] Once the MBean information has been retrieved from the 

MBean Server, the MBeanHome examines the MBean information to 
determine the MBean type. Any MBean of a given type will have the 
same methods and attributes. The MBeanHome has access to data 
describing the methods and attributes available to each MBean type. 
20 By matching the MBean type to data on the attributes and methods 

available to each MBean type, the MBeanHome is able to determine all 
of the attributes and methods available for the specific Mbean. 
[0048] Next, the MBeanHome selects an interface class for the 
requested MBean. The interface class defines a strongly-typed 
25 interface for the attributes and methods of the MBean. In an 

embodiment, the interface class enumerates all of the methods and 
attributes available to a specific MBean. The class interfaced fines th 
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specific data types employed by each of the available methods and 
attributes. Additionally, the class interface specifies valid values for 
each attribute. In order to work with the class interface, the 
MBeanHome creates a class interface object, which is a Java™ object 
5 instantiating the class interface. 

[0049] In addition to creating the class interface object, the 
MBeanHome creates an instance of an invocation handler object forthis 
MBean. An invocation handler is an interface type standardized in 
Java™ 2 Platform, Standard Edition, v. 1.3, API Specification. This 

10 specification, available at 

http://java.sun.eom/j2se/1.3.0/docs/api/overview-summary.html is 
incorporated by reference herein. Objects implementing this interface 
handle methods invoked on a proxy object. When a method is invoked 
on a particular proxy object, the method call is passed to the invoke 

15 method of the invocation handler defined for the proxy object. The 

invoke method must then parse the method call and perform the 
required action. 

[0050] For the invocation handler associated with a specific 
MBean, the invoke method is capable of parsing each method and 

20 attribute available to the MBean. When a user invokes a method on the 

MBean proxy, the invoke method of the invocation handler parses the 
method and formulates one or more generic JMX calls in response. 
These generic JMX method calls are then invoked on the specified 
MBean via the MBean Server. The results of these generic JMX 

25 method calls, if any, are then returned to the invoke method of the 

invocation handler. The results are then cast into the data type 
specified by the interface, if necessary, and returned to the user. 
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[0051] A properly implemented invocation handler is needed for 
the correct operation of the MBean proxy. The invocation handler must 
implement every method and attribute of the MBean class interface in 
exactly the correct manner. Each method of the MBean class interface 
5 must be correctly parsed into the property formatted JMX calls. Further, 

any data passing through the MBean proxy must be precisely cast into 
the correct data types. Failure to comply with these requirements will 
result in runtime errors. In this case, runtime errors will be concentrated 
in the invocation handler, rather than the user application. The 
10 invocation handler is typically developed by the Server program 

developer. Since the Server program developer is generally more 
careful and performs more product testing than the typical user, runtime 
errors are much less likely to occur. 

[0052] Once the invocation handler and the class interface 
15 objects have been created, the MBeanHome is ready to create the 

MBean proxy. The MBean Proxy is created using a Java™ dynamic 
proxy factory method. The dynamic proxy factory combines the class 
interface object with the invocation handler object to create a proxy 
object. This proxy object implements the interface of the interface 
20 object with the functionality provided by the invocation handler. By 

combining the MBean-specific class interface object with the MBean 
invocation handler, the dynamic proxy factory produces an MBean 
proxy object. The completed MBean proxy is then returned to the user 
to enable future MBean access. 
25 [0053] The following sample source code implements a dynamic 

proxy factory: 
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static public Object newlnstance(Object obj, CIass[ ] 

Classlnterfaces) 

{ 

return Java.lang.reflectProxy.newProxylnstance 
(obj.getClass().getClassLoader(), 
Classlnterfaces, new DynamicProxyClass(obj)); 

} 

This dynamic proxy factory combines the interface defined by 
Classlnterfaces and the invocation handler defined by 
DynamicProxyClass to create a dynamic proxy. 
[0054] In an alternate embodiment, the MBeanHome receives a 
search request from the user. The MBeanHome then performs this 
search in order to find all the MBeans matching the user's search 
criteria. The MBeanHome then makes a series of generic JMX calls on 
the MBean Server to retrieve MBean information for each MBean 
meeting the search criteria. The remaining steps of the MBean proxy 
creation are carried out as described above, with each step performed 
separately for each MBean matching the search criteria. In an 
embodiment, following the creation of all of the corresponding MBean 
proxies, the MBeanHome returns a single iterator object containing all 
of the created MBean proxy objects to the user. The user may then 
extract each MBean proxy from the iterator. 

[0055] The foregoing description of the preferred embodiments 
of the present invention has been provided for the purposes of 
illustration and description. It is not intended to be exhaustive or to limit 
the invention to the precise forms disclosed. Obviously, many 
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modifications and variations will be apparent to practitioners skilled in 
the art. The embodiments were chosen and described in order to best 
explain the principles of the invention and its practical applications, 
thereby enabling others skilled in the art to understand the invention for 
5 various embodiments and with the various modifications as are suited 

to the particular use contemplated. It is intended that the scope of the 
invention be defined by the following claims and their equivalents. 
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CLAIMS 



1 . A proxy for controlling a management entity, comprising: 

an application interface that communicates with an application, 
5 wherein the application interface includes at least one application 

function associated with the management entity for operating on a 
portion of the management entity; 

a function translator that produces at least one management 
function corresponding to an application function; and 
10 a management interface that communicates with the 

management entity via the corresponding management functions. 



2. The proxy of Claim 1 f wherein: 

each application function associated with the management entity 
15 utilizes a specific data type associated with the management entity. 



3. The proxy of Claim 1 , wherein: 

the portion of the management entity is a management attribute. 

20 4. The proxy of Claim 1 , wherein: 

the portion of the management entity is a management function. 



5. The proxy of Claim 1 , wherein: 

25 the management entity is a Java MBean. 

6. The proxy of Claim 5, wherein: 
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the MBean is associated with a run-time operation. 



7. The proxy of Claim 5, wherein: 

the MBean is associated with a network resource. 

8. The proxy of Claim 1 , wherein: 

the function translator and the management interface comprise 
a Java invocation handler. 



10 9. The proxy of Claim 1 , wherein: 

the application is a management application. 

1 0. The proxy of Claim 1 , wherein: 
the application is a MBean Server. 

15 

1 1 . The proxy of Claim 5, wherein: 

the management interface communicates management functions 
to the management entity via an MBean Server. 

20 1 2. The proxy of Claim 5, wherein: 

the management interface communicates management functions 
to the management entity via an MBeanHome. 



1 3. The proxy of Claim 2, wherein: 
25 the management interface receives a data response to at least 

one of the communicated management functions from the management 
ntity; 
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the function translator converts the data response to the specific 
data type utilized by the application function associated with the 
management entity; and 

the application interface communicates the converted data 
5 response to the application via the application function. 

14. A method for creating a proxy for controlling a management 
entity, comprising: 

(a) retrieving entity information describing the management 
10 entity in response to an application request; 

(b) evaluating the entity information to determine a 
management entity type instantiated by the management entity; and 

(c) creating a proxy adapted to the management entity type 
and associated with the management entity. 

15 

15. The method of Claim 14, wherein Step (c) comprises: 
creating an interface class object specifying an application 

interface associated with the management entity type; 

creating an instance of an invocation handler associating at least 
20 the application interface with a corresponding management interface; 

and 

invoking a proxy creation method on at least the instance of the 
invocation handler and the interface class object to create a proxy object 
associated with the management entity. 

25 



16. 



The method of Claim 14, wherein: 

the application request specifies a managem nt entity. 
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1 7. The method of Claim 1 6, further comprising the step of: 
returning the proxy object to the application. 

1 8. The method of Claim 14, wherein: 

5 the application request specifies the value of at least one 

management attribute. 

1 9. The method of Claim 18, wherein Step (a) further comprises: 
locating management entities having the specified management 

10 attribute; and 

retrieving entity information for a located management entity 
matching the value of the specified management attribute. 

20. The method of Claim 19, further comprising the step of: 
15 returning the proxy object to the application in an iterator; 

21 . The method of Claim 14, wherein: 

the management entity is a Java MBean. 

20 22. The method of Claim 21 1 wherein: 

the MBean is associated with a run-time operation. 

23. The method of Claim 21 , wherein: 

the MBean is associated with a network resource. 



25 



24. The method of Claim 21 , wherein: 

the entity information is retrieved from an MBean Server. 
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25. A system for managing services of a distributed processing 

system, comprising: 

a management entity of a specific management entity type 

associated with a service of the distributed processing system and 
5 having a management entity interface; 

an application having an application interface; and 

a management entity proxy for communicating information 

between the management entity and the application, wherein 

communication with the management entity is via the management 
10 entity interface, and wherein communication with the application is via 

the application interface. 



26. The system of Claim 25, wherein: 

the management entity interface includes at least one 
15 management entity function disassociated with the specific entity type; 

and 

the application interface includes at least one application function 
associated with the specific management entity type. 



20 27. The system of Claim 26, wherein: 

the communication via the management entity interface utilizes 
the management entity function; and 

the communication via the application interface utilizes the 
application function. 

25 

28. The system of Claim 26, wherein: 

the application function utilizes a specific data typ associated 
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with the specific management entity. 



29. The system of Claim 28, wherein: 

the management entity function utilizes a general data type 
5 disassociated with the specific management entity. 



30. The system of Claim 29, wherein: 

the management entity proxy converts information to the general 
data type for communication with the management entity; and 
10 the management entity proxy converts information to the specific 

data type for communication with the application. 



31 . The system of Claim 25, further comprising: 

a management entity handler for communicating information 
15 between the management entity and the management entity proxy. 

32. The system of Claim 31 , wherein: 

the management entity handler is comprised of a Java MBean 
Server. 

20 

33. The system of Claim 32, wherein: 

the management entity handler is further comprised of an 
MBeanHome . 



25 



34. The system of Claim 25, wherein: 

the service of the distributed processing system associated with 
the management entity is a management attribute. 
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35. The system of Claim 25, wherein: 

the service of the distributed processing system associated with 
the management entity is a management function. 

5 36. The system of Claim 25, wherein: 

the management entity is a Java MBean. 

37. The system of Claim 36, wherein: 

the service of the distributed processing system is a run-time 
10 operation. 

38. The system of Claim 36, wherein: 

the service of the distributed processing system is a network 
resource. 

15 

39. The system of Claim 36, wherein: 

the management entity proxy includes a Java invocation handler. 



40. The system of Claim 36, wherein: 
20 the application is an MBean Server. 

41 . A method for converting functions of a strongly-typed interface to 
functions of a generic interface, comprising: 

receiving a function invocation from the strongly-typed interface; 
25 identifying the function invocation as an invocation of a function 

of a specific function type; 

selecting at least one generic function of the generic int rface 
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corresponding to the specific function type; and 
invoking the generic function. 

42. The method of Claim 41 , further comprising: 

5 in the step of receiving, receiving a function argument of a first 

data type associated with the function invocation; 

converting the function argument to a generic function argument 
of a second data type associated with the generic function; and 

in the step of invoking, invoking the generic function with the 
10 generic function argument 

43. The method of Claim 41 , further comprising: 

receiving a generic function response of a first data type from the 
generic function; 

15 converting the generic function response to a function response 

of a second data type associated with the function invocation from the 
strongly-typed interface; and 

responding to the received function invocation with the function 
response of the second data type. 

20 

44. The method of Claim 41 , wherein: 

the generic function is a Java JMX function. 

45. An article of manufacture including an information storage 
25 medium wherein is stored information, the information comprising: 

a group of processor readable instructions adapted to operate on 
a processing devic , wherein the group of processor readable 
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instructions are adapted to operate the processing device according to 
the method of Claim 14. 



46. An article of manufacture including an information storage 
5 medium wherein is stored information, the information comprising: 

a group of processor readable instructions adapted to operate on 
a processing device, wherein the group of processor readable 
instructions are adapted to operate the processing device according to 
the method of Claim 41 . 

10 

47. A proxy for controlling a management entity, comprising: 

an application interface means for communicating with an 
application, wherein the application interface means includes at least 
one application function associated with the management entity for 
15 operating on a portion of the management entity; 

a function translator means for producing at least one 
management function corresponding to an application function; and 

a management interface means for communicating with the 
management entity via the corresponding management functions. 



20 
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